Skip to main content
Get the task-based match score between two task sets
curl --request POST \
  --url https://{tenant_name}.{region}.techwolf.ai/tasks/matching \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "source_tasks": [
    {
      "task_id": "a7844da2-b2b2-42da-818a-006785d8e78d",
      "weekly_hours": 8
    },
    {
      "task_id": "dc6b2225-fa29-4c4b-8102-b218b70a8287"
    }
  ],
  "target_tasks": [
    {
      "task_id": "d7b51744-5c02-4274-85ac-d6fe1a480a85"
    },
    {
      "task_id": "960bc9a9-cbaa-4c84-8539-7c0755b27ef9",
      "weekly_hours": 4
    }
  ]
}
'
{
  "score": 0.42
}

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Query Parameters

​
response_format
enum<string>
default:simple

If set to explained, the response will include an explanation of the match.

Available options:
simple,
explained
Example:

"explained"

Body

application/json

A pair of task sets to compare. Both sides are explicit lists of existing tasks, each optionally weighted by weekly hours; the match score is computed directly from their task embeddings.

​
source_tasks
object[]
required

Source task set. Must contain between 1 and 100 tasks; every task_id must reference an existing Task in the system.

Required array length: 1 - 100 elements
Example:
[
  {
    "task_id": "a7844da2-b2b2-42da-818a-006785d8e78d",
    "weekly_hours": 8
  },
  {
    "task_id": "dc6b2225-fa29-4c4b-8102-b218b70a8287"
  }
]
​
target_tasks
object[]
required

Target task set. Must contain between 1 and 100 tasks; every task_id must reference an existing Task in the system.

Required array length: 1 - 100 elements
Example:
[
  {
    "task_id": "d7b51744-5c02-4274-85ac-d6fe1a480a85"
  },
  {
    "task_id": "960bc9a9-cbaa-4c84-8539-7c0755b27ef9",
    "weekly_hours": 4
  }
]

Response

OK

An ad-hoc task-based match result between two task sets.

​
score
number<float>
required

The symmetric task-based match score between the two task sets, expressed as a number between 0 and 1.

Required range: 0 <= x <= 1
Example:

0.42